Xbasic

UI_DLG_PANEL Function

Syntax

V UI_DLG_PANEL(C title,C dialog format[,C code])

Arguments

Result

The value returned by the dialog. This is typically the name of the BUTTON that was pressed to close the dialog.

title

The title of the dialog. The title may also be specified dynamically using the syntax: Title = "@=" + Title_Var_Name.

dialog

Format_StringA series of Xdialog commands that describe the appearance of the dialog box. The basic structure of the Format section is:

<<%dlg%
Xdialog_Code
%dlg%
Argument
Description
<<%dlg%

The only optional part of this argument is the "dlg" sequence of characters (the marker), which can be any string of characters, as long as it is unique within this instance of the UI_DLG_BOX() function. The character sequence is specifically recommended because it is supported by bubble help.

Xdialog_Code

Xdialog_CodeOne or more statements, each of which must be on a separate line from the and %dlg% arguments.

%dlg%

The marker characters can be any string of characters, as long as they match those in the first argument ( ).

code

Optional. Xbasic code that describes what should happen when various events happen when the user is interacting with the dialog box. For example, what should happen when the user presses a button, or when the user tabs out of a field. The basic structure of the Event Handling section is:

<<%code%
Xbasic_Code
%code%

Description

Create an xdialog panel - this is an xdialog that lives in a panel - and doesn't need to exist to honor automation.

Discussion

The UI_DLG_PANEL() function creates an Xdialog box.

Limitations

Desktop applications only.

See Also